home *** CD-ROM | disk | FTP | other *** search
/ Corel CD Power Pak: Utilities / Corel CD Power Pak: Utilities.iso / scsi2 / aspidrv.cmd < prev    next >
OS/2 REXX Batch file  |  1993-10-19  |  10KB  |  243 lines
  1.          ASPIDRIVER V1.00 command line switches
  2.         --------------------------------------
  3.  
  4. DEVICE=ASPIDRV.SYS [/l] [/m] [/n<slot>] [/a<bus-on time>] [/b<bus-off time>]
  5.     [/i] [/j<HAN>] [/x<port>] [/p<port>] [/d <HAN>,<ID>,<BYTE>]
  6.     [/z <slot>] [/s<dma-speed>] [/r[w]] [/h]
  7.  
  8. /L    enable nonzero LUN SCSI scanning at boot (for ASPI=1 GetDeviceType)
  9. /M    disable full message display during boot
  10.  
  11. /I    disable int 13h module loading;by default int 13h module is loading
  12.     for host adapter number zero
  13.  
  14. /W<buffer size in KBytes>    allocate a high memory buffer below 16 MB
  15.     for aspi manager buffered mode option
  16.  
  17. /X<port>exclude port from install (AT BUS)
  18. /P<port>install port number (AT BUS) - can be given multiple times
  19.     if no /p option exists the driver is autoscanning the SCSI bus and
  20.     installing all supported cards on AT BUS
  21.  
  22. /Z<slot>exclude slot from install (MCA BUS)
  23. /N<slot>install slot number (MCA BUS) - can be given multiple times
  24.     if no /n option exists the driver is autoscanning the SCSI bus and
  25.     installing all supported cards on MCA BUS
  26.  
  27. /R    do SCSI hard reset to all found host adapters.This option is useful
  28.     after a host adapter previous "hang" (the host adapter LED remains
  29.     on after reset,the card is not recognised at boot by the driver,etc)
  30. /RW    do SCSI hard reset and wait 5 seconds before any SCSI request is made
  31.     to the host adapter (for slow old SCSI devices that could "hang" the
  32.     host adapter after SCSI bus reset is sent)
  33.  
  34. /D<HAN>,<ID>,<BYTE> set unique parameter byte configuration option for
  35.     the specified host adapter and SCSI ID.You can set the following bits
  36.         bit2-prevent target disconnect
  37.         bit3-no autosense
  38.     For details about the configuration byte see ASP=5 Set Host Adapter
  39.     parameters 
  40.  
  41. /A<bus on  time decimal> AT BUS only - specifies the amount of time the host
  42.     adapter bus master is allowed to hold the bus (range is 2-15 uS); the
  43.     default is 11 uS
  44. /B<bus off time decimal> AT BUS only - specifies the amount of time the host
  45.     adapter bus master must release the bus (range is 1-64 uS); the 
  46.     default is 4 uS
  47.  
  48. /S<DMA transfer speed hexa> AT BUS only - specifies the DMA timing of the host
  49.     bus master chip;the allowed values are
  50.         00 - 5.00 MB/second
  51.         01 - 6.67 MB/second
  52.         02 - 8.00 MB/second
  53.         03 - 10.0 MB/second (the maximum rate)
  54.         04 - 5.70 MB/second
  55.         FF - 3.33 MB/second (the minimum rate)
  56.  
  57.         ASPIDRIVER V1.00 initialization and mesages
  58.         -------------------------------------------
  59.  
  60.     Note : most of the initialization messages can be disabled to be 
  61.     displayed with the /M option.
  62.  
  63.     After the initial message
  64.  
  65.     "CorelASPI for DOS - device driver V1.00"
  66.     "Copyright (c) 1992-1993 Corel Corp."
  67.  
  68.     the driver starts processing of the config.sys line. If any i/o ports
  69.     are specified the driver tries installing only the cards that
  70.     correspond to the specified ports;else the driver scans the AT or MCA 
  71.     bus for valid SCSI supported cards and installs them all. If none is 
  72.     found the driver exits without installing with the message
  73.  
  74.     "No supported SCSI cards located"
  75.     "Driver is not installed"
  76.  
  77.     At the end of the initialization the exit message displays the
  78.     number of SCSI cards installed.
  79.  
  80.      "Installation complete : x SCSI  card(s)   located"
  81.  
  82.     x-number of installed cards
  83.  
  84.     Any config.sys command error is ignored with the message
  85.  
  86.     "Unknown command line errors ignored"
  87.  
  88.     The per card host adapter specific initialization starts with the 
  89.     message
  90.  
  91.         "Initialising host adapter : x"
  92.      "Configuration I/O : yyyy, IDD : d, IRQ : bb, DMA : a"
  93.  
  94.     x-host adapter number (0 based)
  95.     yyyy-base I/O port for the card
  96.     d-the bord ID byte as returned by adapter inquiry command
  97.     bb-interrupt level for the card
  98.     a-dma channel for the bus master chip
  99.  
  100.     On the MCA bus the slot number is displayed
  101.  
  102.     "Microchannel slot : x"
  103.  
  104.     x-slot number (1-8)
  105.  
  106.     The driver is scanning the SCSI bus for present devices and displayes
  107.     the results. If the /L option is specified the scanning is made for
  108.     every SCSI LUN on a given SCSI ID, else the inquiry is made only for
  109.     LUN = 0 on a given ID.
  110.  
  111.     The /A /B /S command line switches display the programming of the
  112.     specified parameters. These parameters are GLOBAL for EVERY installed
  113.     card.
  114.  
  115.         "Configuring bus  on  time to xx uS"
  116.  
  117.      "Configuring bus  off time to yy uS"
  118.  
  119.         "Configuring DMA XFER RATE to aa.bb MB/S"
  120.     "DMA timing is tRR : mmm nS, tWW : nnn nS, tOFF : ppp nS"
  121.  
  122.     xx-value in uSeconds for bus-on time
  123.     yy-value in uSeconds for bus-off time
  124.     aa.bb-value in mbytes/second of the dma bus transfer rate
  125.     mmm-value in nSeconds of the read pulse width on a dma transfer as
  126.     specified in the manufacturer's data sheet
  127.     nnn-value in nSeconds of the write pulse width on a dma transfer as
  128.     specified in the manufacturer's data sheet
  129.     ppp-value in nSeconds of the inactive command (read or write) pulse 
  130.     width on a dma transfer as specified in the manufacturer's data sheet
  131.     These values are 100-450 nS in increments of 50 nS.
  132.     Note:the DMA speed is shown with the following formula
  133.         Rdma[MB/s] = 2 bytes/word * (10**3) * (1/((tRR+tWW)/2+tOFF))
  134.     where the timings are in nanoseconds.
  135.     The value of the byte for the /S  command is the following
  136.         bit7 always set
  137.         bit6-4=tRR 0-7 means tRR=100-450nS in 50nS increments
  138.         b3=0/1 tOFF=100/150nS
  139.         bit2-0=tWW 0-7 means tWW=100-450nS in 50nS increments
  140.  
  141.     If the per card initialization is succesfull the last message is
  142.  
  143.         "Initialising complete host adapter : x"
  144.  
  145.     else
  146.  
  147.     "Initialising error host adapter : x error : yyyy"
  148.  
  149.     x-host adapter number (0 based) 
  150.     yyys-the error code
  151.     In this last case the driver displays also a corresponding error 
  152.     string.Also in should be noted that in this last case the driver is
  153.     not installing FOR the specified card.
  154.  
  155.     If there are any present SCSI hard disks, the driver changes the
  156.     hard disk interrupt services vector. If there are any CMOS installed
  157.     hard disks, the driver installs the vector only if maximum ONE CMOS
  158.     hard disk is present.Remember that the /I option disables the loading
  159.     of the int 13h vector. Use this option if you have no SCSI hard drives
  160.     in your system, so that the driver do not keep the code for int 13h 
  161.     resident. However you should not use the /I option if you are loading
  162.     in config.sys EMM386.EXE or any other expanded memory manager.The 
  163.     driver should be loaded BEFORE any expanded memory manager and the
  164.     HIMEM.SYS driver (or the equivalent XMS driver).
  165.  
  166.     Upon succesfull instalation of the vector the driver displays the 
  167.     message
  168.  
  169.     "ASPI - hard disk interrupt SCSI module  V1.00"
  170.     "INT 13H redirected - for X:,Y drive(s)"
  171.  
  172.     X=start drive for which the vector is installed (C: or D:) 
  173.     Y=number of SCSI hard drives for which the vector is installed (1 or 2)
  174.  
  175.     Following are the int 13h error messages
  176.  
  177.     "SCSI device id 0 lun 0 not a direct access device"-if you wish
  178.     to install as a "hard drive" a SCSI device with device type 7 you
  179.     should use the /H switch.
  180.  
  181.     "INT 13H function error"-the BIOS read drive parameters failed
  182.  
  183.     "Read test INT 13h error"-the verify test with the new int 13h
  184.     vector failed.
  185.  
  186.     NOTE:    on MCA (but not only) if there are two cards installed in
  187.     the system and the boot hard drive is on the second card you could
  188.     see a message (primary card 330h,secondary card 230h)
  189.  
  190.     "Unable to read POS register information"
  191.  
  192.     This means that you have to reconfigure the cards so that the boot
  193.     card to be ON the 330h port based card.
  194.  
  195.     The autoscan on MCA bus is in the order slot #1 to slot #8.
  196.  
  197.     If the slot in which the SCSI boot hard disk is present is AFTER
  198.     another SCSI card slot (slot 4 non bootable SCSI card, SCSI 6 hard
  199.     disk to boot from), the int 13h vector will not install properly
  200.     unless you specify /j1 (int 13h vector on host adapter number 1). As
  201.     an alternative you can specify on the command line /n6 /n4 as in our
  202.     example, to force the installation of the cards in your own order.
  203.     This will ensure that the boot host adapter number IS zero
  204.     and the int 13h vector installs by default.
  205.  
  206.     On the AT bus the autoscanning order is f